home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / music / pcmusic.arj / USER.DOC < prev    next >
Text File  |  1993-09-21  |  5KB  |  140 lines
  1.  
  2.                                                      USER.DOC  Page 1 of 3
  3.  
  4.  
  5.  
  6.  
  7.      PC MUSIC MAKER
  8.  
  9.  
  10.      PC MUSIC MAKER (PCMM) is actually a demonstration program intended
  11.      to show the capabilities of the PC speaker to make music and/or
  12.      sound effects. It is fun to use to play your favorite tune or to
  13.      generate new and unusual sounds. Several songs with have been included
  14.      with this package. There is also several sound effects included. It is
  15.      programmed to run with EGA/VGA monitor. It may reside on floppy disk
  16.      or hard disk. 
  17.  
  18.      The author knows very little about music, but, he does know how to
  19.      tell you how to use PC MUSIC MAKER. The PC speaker has NO volume
  20.      control except for frequency. Some PC speakers are very loud and are
  21.      more of a nuisance than a help. And some are so weak that it is very
  22.      hard to hear them even when sitting directly in front of them. Keep
  23.      this in mind when choosing which octave to play a tune.
  24.  
  25.      There are three (3) modes of operation to PC MUSIC MAKER:
  26.  
  27.         1) Data Maintenance - Has three (3) functions.
  28.  
  29.            A. Build - Create a sound file up to 9 lines of data. This
  30.                       allows room for most songs.
  31.  
  32.            B. Load  - Retrieve a previously created sound file.
  33.  
  34.            C. Edit  - Change a sound file.
  35.  
  36.  
  37.         2) PC Music - Has only (1) function.
  38.  
  39.            A. Play PC - Start the music or sound effect. Pressing any
  40.               key while PLAY PC is executing will stop the music. But,
  41.               if the pressed key is a 'P' it will restart at the
  42.               beginning.
  43.  
  44.   
  45.         3) Special functions - Has three (3) functions.
  46.  
  47.            A. Change Directory - Changes the location of where the sound
  48.                                  files will be "saved to" or "loaded from".
  49.  
  50.            B. Delete - Delete a sound file from the current directory.
  51.  
  52.            C. Quit   - Stop PC MUSIC MAKER (Return to DOS).
  53.  
  54.  
  55.                                                      USER.DOC  Page 2 of 3
  56.  
  57.      Sound files may be built (generated) by using any ASCII editor or by
  58.      the BUILD function of PC MUSIC MAKER. Only files created by the BUILD
  59.      function can be EDITED with the EDIT function. Most songs will not use
  60.      more than the nine lines allowed by PC MUSIC MAKER. Music created by
  61.      using an ASCII editor are limited to 2500 characters.
  62.  
  63.                        PC MUSIC MAKER COMMANDS
  64.  
  65.        ;    Semicolon. Signals the start of a comment in a sound
  66.             file. Comments are stripped off before the music
  67.             commands are passed to the SOUND DRIVER.
  68.  
  69.        '    Single quote. Signals the start and stop of a title
  70.             to be display when the music is played. Only one title
  71.             is allowed for each sound file. Subsequent single quotes
  72.             are discarded. A title is only recognized if it is in
  73.             a comment line.
  74.  
  75.        Tn   Tempo is the speed at which the music is played.  n is
  76.             a decimal number between 32 and 255.  The larger the
  77.             number, the faster the music will be played.
  78.  
  79.        On   Octave.  n is a decimal number between 0 and 7.  Most
  80.             common songs use Octave 3 or 4. Octave 6 & 7 are very hard
  81.             to hear on the PC Speaker.
  82.  
  83.        Ln   Length of time the notes will be played, relative to Tempo,
  84.             until the next L command is detected. n is a decimal number
  85.             between 1 and 64. (ie:  L4 = quarter-note and L8 = eighth
  86.             note.)
  87.  
  88.        A-G  Letters corresponding to the notes of the scale. The letter
  89.             may be followed by either a # for a sharp, or a - for a flat.
  90.  
  91.        Rn   Rest, or pause, for a length defined by n. R works in the
  92.             same way as the L command above. (ie: R2 = a half rest)
  93.  
  94.        .    Dot.  A dot can follow a letter note or a rest. A dotted
  95.             note increases play time by half the duration of the note or
  96.             rest.  More than one dot may be used.
  97.  
  98.        MN   Music Natural. The note is played 7/8 of its allotted time,
  99.             and 1/8 is the time between notes.
  100.  
  101.        ML   Music Legato. The note is played the full length of time
  102.             allotted.
  103.  
  104.        MS   Music Staccato.  The note is played 3/4 of the time allotted,
  105.             and 1/4 is the time between notes.
  106.  
  107.                                                      USER.DOC  Page 3 of 3
  108.  
  109.  
  110.  
  111.      Now, lets try an example:
  112.  
  113.             ;AMBULANCE  'Going to the hospital'                                       
  114.  
  115.             T176 ML L8 O3 A O4 A O3 A O4 A O3 A O4 A O3 A O4 A
  116.  
  117.      There is a comment line (;) and a title ('). The title will be
  118.      displayed when the SOUND FILE (AMBULANCE) is played. The Tempo is
  119.      fairly fast (T176), Music Legato has been choosen and Eighth notes
  120.      selected. Play the note (A) in Octave 3 then 4 alternately. The
  121.      spaces are not required and the commands can be lower case.
  122.  
  123.  
  124.  
  125.      Program developers please refer to the DEVELOP.DOC for information
  126.      on how to obtain and use the SOUND DRIVER in your programs.
  127.  
  128.  
  129.      Technical support for PC MUSIC MAKER is provided at no charge by
  130.      contacting the author:
  131.  
  132.  
  133.      Ronald L. Crabb
  134.      2113 White Cloud NE
  135.      Albuquerque, NM 87112
  136.      Ph: (505) 299-6285
  137.  
  138.  
  139.  
  140.